home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / gapcdr6.zip / WHATS.NEW < prev   
Text File  |  1993-04-19  |  9KB  |  212 lines
  1.  
  2. 04/16/93
  3.  
  4.   GAPCDR now supports the DigiBoard COM/Xi series of Intelligent
  5.   Serial Communications boards. These boards contain 4 or 8 serial
  6.   ports along with their own on-board processor to control the ports.
  7.   These boards are actually a single-board computer dedicated to handling
  8.   serial port I/O.
  9.  
  10.   By moving the serial I/O functions from the Host Computer to the
  11.   DigiBoard, the IRQ and Interrupt Latency bottleneck that plagues
  12.   Multi-Tasking users is eliminated. 
  13.  
  14.   GAPCDR supports the DigiBoard in two ways:
  15.  
  16.         Direct Programming and INT14/EBIOS calls.
  17.  
  18.     Direct Programming is the fastest because it eliminates the need
  19.     for costly software interrupt calls to a slower BIOS. In addition
  20.     it does not require the presence of a Device Driver which basically
  21.     performs the same functions as the Direct Programming method.
  22.  
  23.     INT14/EBIOS requires that a Device Driver be loaded (this driver
  24.     is supplied by DigiBoard). Serial Port I/O is performed by issuing
  25.     software interrupts (Interrupt 14). 
  26.  
  27.   Whether or not to use the Direct Interface or the INT14/EBIOS
  28.   Interface depends on the BBS which will be running the GAPCDR
  29.   program. If the BBS is utilizing the Device Driver, then that is
  30.   how a GAPCDR program must be configured. If the BBS is a GAP system
  31.   and the Sysop is using the Direct Interface, then the GAPCDR program
  32.   must be configred the same.
  33.  
  34.   The two interfaces can not be intermixed since the Direct Interface will
  35.   essentially put the Device Driver to sleep.
  36.  
  37.   When using the INT14/EBIOS interface and the DigiBoard supplied Device
  38.   Driver, it is not necessary to turn on the "Character Waiting" flags
  39.   for each of the ports. GAPCDR does not use these flags as they basically
  40.   defeat the purpose of using a multi-port board in a multi-tasking
  41.   system. To use these flags an IRQ must be dedicated to the DigiBoard.
  42.   If the flags are not used, the IRQ need not be set.
  43.  
  44.      Imagine running 8 ports under a Multi-Tasker where all 8 ports
  45.      are in use. As characters are received by each of the 8 ports, an
  46.      interrupt is generated. The Device Driver must service the
  47.      interrupt request and since the driver runs on the Host Computer,
  48.      it will be spending a lot of precious time figuring out which of
  49.      the ports generated the interrupt and updating its "Character
  50.      Waiting" flag for that port.
  51.  
  52.      By disabling the "Character Waiting" flags and not utilizing the
  53.      IRQ, the Host Computer will not know it has 8 serial ports running
  54.      at high speed at the same time.
  55.  
  56.   If, however, the Sysop has the IRQ and Character Waiting flags enabled,
  57.   no harm is done. GAPCDR simply will not utilize the flags.
  58.  
  59.   The Character Waiting flags are provided because making Interrupt
  60.   14 calls takes longer than simply checking a memory address (which,
  61.   by the way, is what the Direct Programming interface does).
  62.  
  63.   To use a DigiBoard with a GAPCDR program, 4 additional lines have been
  64.   added to the Door Configuration file. These 4 new options are:
  65.  
  66.     Line 5 - The COM Port Interface to use:
  67.  
  68.              STANDARD    = Regular Communications Port Interface. This
  69.                            is what you would normally use.
  70.  
  71.              DIGIBOARD   = Direct DigiBoard Programming Interface. Must
  72.                            be used in conjunction with a program called
  73.                            RESETDIG.EXE. If you don't have this program
  74.                            but have a DigiBoard, then use the following
  75.                            option.
  76.  
  77.              INT14/EBIOS = Indirect DigiBoard Support via a Device Driver.
  78.                            All Communications to the DigiBoard (or any
  79.                            board that supports INT14/EBIOS) are performed
  80.                            via a Software Interrupt that the Device Driver
  81.                            handles.
  82.  
  83.     Line 6 - This is the DigiBoard Memory Window, or the address the
  84.              card uses as a communications area between the card and
  85.              the Host Computer. Only needed if using an Interface set
  86.              to DIGIBOARD. If using STANDARD or INT14/EBIOS, this can
  87.              be set to 0. This address must be entered in Hexadecimal.
  88.  
  89.                Valid entries are: C000, C800, D000, and D800
  90.  
  91.     Line 7 - This is the DigiBoard I/O Port address that the Board is
  92.              attached to. Only needed if using an Interface set to
  93.              DIGIBOARD. If using STANDARD or INT14/EBIOS, can be set
  94.              to 0. This address must be entered in Hexadecimal.
  95.  
  96.                Valid entries are: 100, 110, 120, 200, 220, 300 and 320
  97.  
  98.     Line 8 - This is the DigiBoard Channel Number for the port this
  99.              program will be utilizing. This is REQUIRED for DIGIBOARD
  100.              and INT14/EBIOS Interfaces. This is 1 - 8 for the
  101.              DIGIBOARD Interface and usually 4 - 11 for the INT14/EBIOS
  102.              Interface. This number tells the program which of the 
  103.              Com Ports on the DigiBoard it should use.
  104.  
  105.  
  106.   The new configuration file for a GAPCDR that will be using a DigiBoard
  107.   Serial port would look like the following:
  108.  
  109.     DOOR.CNF
  110.     ----------------------
  111.     C:\GAP
  112.     The Crow's Nest BBS
  113.     4
  114.     03F8
  115.     INT14/EBIOS
  116.     D000
  117.     320
  118.     4
  119.  
  120.     Lines 3 and 4 are ignored by the program and can be set to 0. 
  121.     Because this is an INT14/EBIOS interface, lines 6 and 7 are also
  122.     ignored. Line 8 is the Channel Number and in this case, it is the
  123.     first serial port on the DigiBoard (Channel Numbers 1 - 4 are
  124.     generally reserved for COM 1 - COM 4 on the Host Computer, although
  125.     this is up to the Sysop and how he/she configured the Device Driver).
  126.  
  127.  
  128.   To use the Direct Programming Interface, the configuration file
  129.   would look something like:
  130.  
  131.     DOOR.CNF
  132.     ----------------------
  133.     C:\GAP
  134.     The Crow's Nest BBS
  135.     4
  136.     03F8
  137.     DIGIBOARD
  138.     D000
  139.     320
  140.     1
  141.  
  142.     Lines 3 and 4 are ignored by the program and can be set to 0. 
  143.     Line 6 is the Memory Window that the DigiBoard and the program
  144.     use to communicate with each other. Line 7 is the I/O port that
  145.     the board uses. Line 8 is the Channel Number which, in this case,
  146.     is the first serial port on the DigiBoard.
  147.  
  148.  
  149.   To use the Standard Com Port Interface, the configuration file
  150.   would look something like:
  151.  
  152.     DOOR.CNF
  153.     ----------------------
  154.     C:\GAP
  155.     The Crow's Nest BBS
  156.     4
  157.     03F8
  158.     STANDARD
  159.     0
  160.     0
  161.     0
  162.  
  163.     Lines 3 and 4 are used ONLY if the program will be using a COM port
  164.     other than COM 1 or COM 2. They can be set to 0 if the program will
  165.     not be using non-standard COM ports. Line 5 tells the program to
  166.     use its own internal interrupt handler. Lines 6-8 are not used and
  167.     can be set to 0.
  168.  
  169.   Note that even if the DigiBoard specific options are not used or needed
  170.   they must still be present in the Configration File and all Door Specific
  171.   options now begin on Line 9.
  172.  
  173.  
  174. 02/18/92
  175.  
  176.   GAPCDR is now compatible with GAPBBS version 6.
  177.  
  178.  
  179. 01/12/91
  180.  
  181.   Since the new MASM 6 does not like the word WAIT to be used as
  182.   a procedure name, the function wait() has been changed to timer().
  183.   
  184.   If you are converting from a previous version of GAPCDR, please
  185.   note that line 3 of the Door Configuration File (the one that was
  186.   either a 0 for GAP or a 1 for PCB, has been removed. GAPCDR no
  187.   longer cares what BBS system it is operating under.
  188.  
  189.     The CNF file now has just 4 required lines. Please consult
  190.     the documentation for the proper format of the Door Configuration
  191.     File.
  192.  
  193.   The show_file function no longer supports the old GAP AnsiCmds
  194.   to clear the screen and disable the More prompt.
  195.  
  196.     Future releases of GAPCDR will include support for the full
  197.     replaceable parameter command set of GAP and PCB.
  198.  
  199.   GAPCDR now writes directly to the screen (and is fully DESQview
  200.   compatible). It contains its own built in ANSI driver. Because
  201.   of the built in ANSI driver, if you used one of the C console
  202.   output statements (printf, cputs, etc), you need to change
  203.   those statments to use the GAPCDR functions of lputs or lputc.
  204.  
  205.     If you use C's console output statments to write to the local
  206.     screen, your local screen will be quite a mess!
  207.  
  208.   All of the GAPCDR functions are now documented. A printed and 
  209.   bound manual is also available. Many new functions were added
  210.   and they are all explained in the manual.
  211.  
  212.